home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 676-700 / 676 / fbm / fbm10man.zoo / MAN / fbquant.man < prev    next >
Text File  |  1990-12-18  |  4KB  |  133 lines
  1.  
  2.      FBQUANT(1)                    25-Jun-90                     FBQUANT(1)
  3.  
  4.  
  5.           3 
  6.  
  7.      ›1mNAME 
  8.           ›0mfbquant \- quantize a 24 bit color image 
  9.  
  10.      ›1mSYNOPSIS 
  11.           ›0mfbquant [ -c<numcolors> ] [ -<type> ] [ -m<map> ] < rgb-image > mapped-image
  12.  
  13.      ›1mDESCRIPTION 
  14.  
  15.                ›0mConverts  a  3  plane red-green-blue color image into a
  16.           mapped color image.  Uses Heckbert's  adaptive  partitioning
  17.           color quantizing  algorithm.   It is strongly suggested that
  18.           you make the number of colors used a power  of  2,  but  not
  19.           necessary for proper operation of FBM.  
  20.  
  21.           If  you  wish  to requantize an image that is already mapped
  22.           (for example, to reduce the number of colors), use "gray2clr
  23.           -u" to unmap the image first.  This unmapping step  is  also
  24.           necessary to resize a color image using fbext(1).  
  25.  
  26.           You  may  specify a particular color map with the -›1mm ›0moption.
  27.           The argument is another mapped color image.  
  28.  
  29.           Note that even if you specify fewer than  256  colors,  some
  30.           output  formats (SUN and FBM) will still use 8 bits to store
  31.           each color index.  The  color  map  will  be  the  specified
  32.           length.  
  33.  
  34.      ›1mOPTIONS 
  35.  
  36.           ›0m-›1mc›0m<›1mnum›0m> ›3mnumber of colors ›0mto use for dithering.  The range is
  37.           8 to 256, and the default is 256.  
  38.  
  39.           -›1mm›0m<›1mmap›0m>  ›3mcolormap  ›0moption,  specifies that the colormap from
  40.           the ›3mmap ›0mimage is to be used to quantize he input.  Colormaps
  41.           may  be  efficiently  stored  by   extracting   very   small
  42.           rectangles from another color image: 
  43.  
  44.                % fbext 0 0 1 1 < image.clr > map.clr 
  45.  
  46.           which stores a 1 pixel image with the desired map.  
  47.  
  48.           -›1mF ›0m›3mFBM,   ›0mformat   (by  default,  the  default).    You  are
  49.           guaranteed not to lose information by specifying FBM as  the
  50.           default.  
  51.  
  52.           -›1mG ›0m›3mGIF, ›0mCompuserve GIF format.  
  53.  
  54.           -›1mI  ›0m›3mIFF  ›0mformat, interleaved bitmaps (ILBM), used by Amigas.
  55.           It is recommended that you use 16 or 32 colors, because  the
  56.           EL  Arts  code  limits IFF files to 6 planes, and most Amiga
  57.           software cannot handle more than 32 colors anyway.  
  58.  
  59.           -›1mS ›0m›3msun, ›0mSun rasterfiles (not run length encoded).  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                       -1-
  66.  
  67.  
  68.      FBQUANT(1)                    25-Jun-90                     FBQUANT(1)
  69.  
  70.  
  71.      ›1mEXAMPLE 
  72.  
  73.                ›0mTo convert a 24 bit Sun rasterfile to an 8  bit  mapped
  74.           color rasterfile: 
  75.  
  76.               % fbquant -S < foo.24bit > foo.clr 
  77.  
  78.           To  convert  a  24  bit  Sun  rasterfile to a 32 color Amiga
  79.           image: 
  80.  
  81.               % fbext -a1.2 -w320 < foo.24bit | \ 
  82.                 fbquant -I -c32 > foo.iff 
  83.  
  84.           To convert an FBM format RGB color image to a 16  color  GIF
  85.           image: 
  86.               % fbext -a1.2 -w320 < foo.24bit | \ 
  87.                 fbquant -G -c16 > foo.gif 
  88.  
  89.      ›1mSEE ALSO 
  90.           ›0mfbm(1) for general discussion, pbm(1) for PBM routines.  
  91.  
  92.      ›1mBUGS 
  93.           ›0mNone known.  
  94.  
  95.      ›1mHISTORY 
  96.           ›0mCopyright  (C)  1989,1990  by Michael Mauldin. Permission is
  97.           granted to use this  file  in  whole  or  in  part  for  any
  98.           purpose,  educational,  recreational or commercial, provided
  99.           that this copyright notice  is  retained  unchanged.    This
  100.           software is available to all free of charge by anonymous FTP
  101.           and in the UUNET archives.  
  102.  
  103.           25-Jun-90  Michael  Mauldin  at  Carnegie  Mellon University
  104.           Release 1.0 mlmcs.cmu.edu 
  105.  
  106.           07-Mar-89 Michael L. Mauldin at Carnegie  Mellon  University
  107.           Beta release (version 0.9) mlmcs.cmu.edu 
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                       -2-
  132.  
  133.